home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / ssignal.z / ssignal
Encoding:
Text File  |  1998-10-20  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSIIIIGGGGNNNNAAAALLLL((((3333CCCC))))                                                        SSSSSSSSIIIIGGGGNNNNAAAALLLL((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssignal, gsignal - software signals
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  13.  
  14.      iiiinnnntttt ((((****ssssssssiiiiggggnnnnaaaallll((((iiiinnnntttt ssssiiiigggg,,,, iiiinnnntttt ((((****aaaaccccttttiiiioooonnnn))))((((iiiinnnntttt))))))))((((iiiinnnntttt))));;;;
  15.  
  16.      iiiinnnntttt ggggssssiiiiggggnnnnaaaallll((((iiiinnnntttt ssssiiiigggg))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _s_s_i_g_n_a_l and _g_s_i_g_n_a_l implement a software facility similar to _s_i_g_n_a_l(2).
  20.      This facility is used by the Standard C Library to enable users to
  21.      indicate the disposition of error conditions, and is also made available
  22.      to users for their own purposes.
  23.  
  24.      Software signals made available to users are associated with integers in
  25.      the inclusive range 1 through 16. A call to _s_s_i_g_n_a_l associates a
  26.      procedure, _a_c_t_i_o_n, with the software signal _s_i_g; the software signal,
  27.      _s_i_g, is raised by a call to _g_s_i_g_n_a_l.  Raising a software signal causes
  28.      the action established for that signal to be _t_a_k_e_n.
  29.  
  30.      The first argument to _s_s_i_g_n_a_l is a number identifying the type of signal
  31.      for which an action is to be established. The second argument defines the
  32.      action; it is either the name of a (user-defined) _a_c_t_i_o_n _f_u_n_c_t_i_o_n or one
  33.      of the manifest constants SSSSIIIIGGGG____DDDDFFFFLLLL (default) or SSSSIIIIGGGG____IIIIGGGGNNNN (ignore).  _s_s_i_g_n_a_l
  34.      returns the action previously established for that signal type; if no
  35.      action has been established or the signal number is illegal, _s_s_i_g_n_a_l
  36.      returns SSSSIIIIGGGG____DDDDFFFFLLLL.
  37.  
  38.      _G_s_i_g_n_a_l raises the signal identified by its argument, _s_i_g:
  39.  
  40.           If an action function has been established for _s_i_g, then that action
  41.           is reset to SSSSIIIIGGGG____DDDDFFFFLLLL and the action function is entered with argument
  42.           _s_i_g.  _G_s_i_g_n_a_l returns the value returned to it by the action
  43.           function.
  44.  
  45.           If the action for _s_i_g is SSSSIIIIGGGG____IIIIGGGGNNNN, _g_s_i_g_n_a_l returns the value 1 and
  46.           takes no other action.
  47.  
  48.           If the action for _s_i_g is SSSSIIIIGGGG____DDDDFFFFLLLL, _g_s_i_g_n_a_l returns the value 0 and
  49.           takes no other action.
  50.  
  51.           If _s_i_g has an illegal value or no action was ever specified for _s_i_g,
  52.           _g_s_i_g_n_a_l returns the value 0 and takes no other action.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      signal(2), sigset(2).
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSIIIIGGGGNNNNAAAALLLL((((3333CCCC))))                                                        SSSSSSSSIIIIGGGGNNNNAAAALLLL((((3333CCCC))))
  71.  
  72.  
  73.  
  74. NOTES
  75.      There are some additional signals with numbers outside the range 1
  76.      through 16 which are used by the Standard C Library to indicate error
  77.      conditions.  Thus, some signal numbers outside the range 1 through 16 are
  78.      legal, although their use may interfere with the operation of the
  79.      Standard C Library.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.